<html>
    <head>
        <title>subNVue 原生子窗体</title>
    </head>
    <body>
        <script>
            /*
                一、概述

                            subNVue ，是 vue 页面的原生子窗体，把weex渲染的原生界面当做 vue 页面的子窗体覆盖在页面上。

                            它不是全屏页面，它给App平台vue页面中的层级覆盖和原生界面自定义提供了更强大和灵活的解决方案。

                            它也不是组件，就是一个原生子窗体。

                            它的设计背景和用途详见：subNVue 原生子窗体开发指南(https://ask.dcloud.net.cn/article/35948)

                            (subNvue 自1.9.10 起支持 ，仅支持 app 平台)
            */  

            /*
                二、uni.getSubNVueById(subNvueId)
                
                            1、兼容性：

                                        元服务
                                        x

                                        HarmonyOS Next 不支持

                            2、概述
                            
                                    通过 ID 获取 subNVues 原生子窗体的实例。 subNVues 配置

                            3、参数

                                        参数	    类型	    说明
                                        subNvueId	String	    原生子窗体的 ID

                            3、代码示例：

                                        const subNVue = uni.getSubNVueById('popup');
                           
                            4、返回值

                                    返回一个 subNVue 对象，详见 subNVue 对象。  
            */

            /*
                三、uni.getCurrentSubNVue()
                        
                        1、兼容性：
                                HarmonyOS Next 不支持

                        2、概述：
                        
                                在一个subnvue窗体的nvue页面代码中，获取当前 subNVues 原生子窗体的实例。

                        3、代码示例（注意执行在nvue页面中）
                                const subNVue = uni.getCurrentSubNVue();

                        4、返回值
                                返回一个 subNVue 对象

                                 <1>、subNVue 对象的方法列表

                                           方法	            说明

                                        ①、show	        显示原生子窗体

                                        ②、hide	        隐藏原生子窗体

                                        ③、setStyle	    设置原生子窗体的样式
            */

            /*
                四、subNVue.show (aniShow,duration,showedCB)
                            
                        1、概述：
                                    
                                显示原生子窗体
                                
                        2、参数列表：

                                    参数	        类型	    默认值	        说明
                                ①、aniShow	        String	    auto	    显示原生子窗体的动画效果 ，如果没有指定窗口动画类型，
                                                                            则使用默认值“auto”，即自动选择上一次显示窗口的动画效果，
                                                                            如果之前没有显示过，则使用“none”动画效果。详见动画类型（https://uniapp.dcloud.net.cn/api/window/subNVues#%E5%8A%A8%E7%94%BB%E7%B1%BB%E5%9E%8B））

                                ②、duration	        Number	    600	        显示原生子窗体的动画持续时间，单位为ms，
                                                                            如果没有设置则使用默认窗口动画时间 600ms。

                                ③、showedCB     	Function		        显示完成的回调函数，当指定原生子窗体显示动画执行完毕时触发回调函数，
                                                                            窗口无动画效果（如"none"动画效果）时也会触发此回调。

                        3、代码示例

                                subNVue.show('slid-in-left',200,()=>{
                                    console.log('subNVue 原生子窗体显示成功')
                                })
            */

            /*
                五、ubNVue.hide (aniShow,duration)
                                    
                        1、概述
                                隐藏原生子窗体

                        2、参数
                                     参数	    类型	    默认值	        说明

                                ①、aniShow	    String	    auto	    隐藏原生子窗体的动画效果 ，如果没有指定窗口动画类型，
                                                                        则使用默认值“auto”，即自动选择上一次显示窗口的动画效果，
                                                                        如果之前没有显示过，则使用“none”动画效果。详见动画类型

                                ②、duration	    Number	    600	        隐藏原生子窗体的动画持续时间，单位为ms，
                                                                        如果没有设置则使用默认窗口动画时间 600ms。

                        3、代码示例：

                                 subNVue.hide('slide-out-left',200)
            */


            /*
                六、subNVue.setStyle (style)

                        1、概述

                                设置原生子窗体的样式

                        2、参数

                                  参数	  类型	        说明
                                  style	 Object	    原生子窗体的样式  

                        3、原生子窗体样式

                                            属性	        类型	        默认值	                描述

                                        ①、position	        String	        absolute	    原生子窗体的排版位置，排版位置决定原生子窗体在父窗口中的定位方式。
                                                                                            可取值："static"，原生子窗体在页面中正常定位，如果页面存在滚动条则随窗口内容滚动；
                                                                                            "absolute"，原生子窗体在页面中绝对定位，如果页面存在滚动条不随窗口内容滚动；
                                                                                            "dock"，原生子窗体在页面中停靠，停靠的位置由dock属性值决定。 
                                                                                            默认值为"absolute"。

                                        ②、dock	            String	        bottom	        原生子窗体的停靠方式,仅当原生子窗体 "position" 属性值设置为 "dock" 时才生效
                                                                                            ，可取值："top"，原生子窗体停靠则页面顶部；
                                                                                            "bottom"，原生子窗体停靠在页面底部；
                                                                                            "right"，原生子窗体停靠在页面右侧；
                                                                                            "left"，原生子窗体停靠在页面左侧。 
                                                                                            默认值为"bottom"。

                                        ③、mask	            HexColor	   rgba(0,0,0,0.5)	原生子窗体的遮罩层,仅当原生子窗体 "type" 属性值设置为 "popup" 时才生效，
                                                                                            可取值： rgba格式字符串，定义纯色遮罩层样式，如"rgba(0,0,0,0.5)"，表示黑色半透明；

                                        ④、width	        String	            100%	    原生子窗体的宽度,支持百分比、像素值，默认为100%。
                                                                                            未设置width属性值时，可同时设置left和right属性值改变窗口的默认宽度。

                                        ⑤、height	        String	            100%	    原生子窗体的高度,支持百分比、像素值，默认为100%。 
                                                                                            当未设置height属性值时，优先通过top和bottom属性值来计算原生子窗体的高度。

                                        ⑥、top	            String	            0px	        原生子窗体垂直向下的偏移量，支持百分比、像素值，默认值为0px。 
                                                                                            未设置top属性值时，优先通过bottom和height属性值来计算原生子窗体的top位置。

                                        ⑦、bottom	        String		                    原生子窗体垂直向上偏移量,支持百分比、像素值，默认值无值（根据top和height属性值来自动计算）。
                                                                                            当同时设置了top和height值时，忽略此属性值； 
                                                                                            当未设置height值时，可通过top和bottom属性值来确定原生子窗体的高度。

                                        ⑧、left	            String	            0px	        原生子窗体水平向左的偏移量，支持百分比、像素值，默认值为0px。 
                                                                                            未设置left属性值时，优先通过right和width属性值来计算原生子窗体的left位置。

                                        ⑨、right	        String		                    原生子窗体水平向右的偏移量，支持百分比、像素值，默认无值（根据left和width属性值来自动计算）。 
                                                                                            当设置了left和width值时，忽略此属性值； 当未设置width值时，可通过left和bottom属性值来确定原生子窗体的宽度。

                                        ⑩、margin	        String		                    原生子窗体的边距，用于定位原生子窗体的位置，支持auto，auto表示居中。
                                                                                            若设置了left、right、top、bottom则对应的边距值失效。

                                        ⑪、zindex	        Number		                    原生子窗体的窗口的堆叠顺序值，拥有更高堆叠顺序的窗口总是会处于堆叠顺序较低的窗口的前面，拥有相同堆叠顺序的窗口后调用show方法则在前面。


                        4、代码示例

                                    subNVue.setStyle({
                                        "position": "absolute", //除 popup 外，其他值域参考 5+ webview position 文档
                                        "width": "50%",
                                        "height": "50%",
                                        "left":"20px",
                                        "top":"100px"
                                    })
            */

            /*
                七、subNVue.postMessage(OBJECT)

                        1、概述

                             发送消息，此通讯方式已过时，请使用uni.$emit进行通讯，参考（https://uniapp.dcloud.net.cn/tutorial/page.html#emit）

                        2、代码示例：

                                    const subNVue = uni.getSubNVueById('subNvue');
                                    subNvue.postMessage({
                                        id:'1'
                                        name:'subNvues'
                                    })      
            */

            /*
                八、subNVue.onMessage(CallBack)

                        1、概述

                            监听消息，此通讯方式已过时，请使用uni.$on进行通讯，参考（https://uniapp.dcloud.net.cn/tutorial/page.html#on）

                        2、代码示例

                            const subNVue = uni.getSubNVueById('subNvue');
                            subNvue.onMessage(function(data){
                                console.log('监听来自所属页面的 message' + JSON.stringify(data));
                            })
            */

            /*
                 九、动画类型

                        1、概述
                                    
                                显示动画与关闭动画，会有默认的对应规则。但是如果通过 API 原生子窗体的关闭动画类型，则不会使用默认的类型

                        2、类型列表

                                            显示动画	            关闭动画	        显示动画描述（关闭动画与之相反）

                                        ①、slide-in-right	    slide-out-right	    新窗体从右侧进入

                                        ②、slide-in-left	    slide-out-left	    新窗体从左侧进入

                                        ③、slide-in-top	        slide-out-top	    新窗体从顶部进入

                                        ⑥、slide-in-bottom	    slide-out-bottom	新窗体从底部进入

                                        ⑦、fade-in	                fade-out	    新窗体从透明到不透明逐渐显示
                                        
                                        ⑧、zoom-out	                zoom-in	        新窗体从小到大缩放显示

                                        ⑨、zoom-fade-out	    zoom-fade-in	    新窗体从小到大逐渐放大并且从透明到不透明逐渐显示

                                        ⑩、pop-in	                pop-out	        新窗体从左侧进入，且老窗体被挤压而出

                                        ⑩、none	                    none	        无动画


                        3、详细的窗口动画说明，请参考：

                                        窗口显示的动画：AnimationTypeShow（https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.AnimationTypeShow）

                                        窗口关闭的动画：AnimationTypeClose（https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.AnimationTypeShow）
            */

            /*
                十、注意事项

                        1、了解更多 subNVue 原生子窗体的用途，请详读subNVues 原生子窗体开发指南

                        2、在hello uni-app的接口-界面-原生子窗体中，有完整的subNVue示例，
                            
                                包括带渐变色的原生导航栏、可遮盖地图的侧滑菜单、可从顶部弹出的popup、可在视频上滚动的消息列表

                        3、每个 subNVue 页面都要在 pages.json 中注册。如果需要全局弹窗，也可以直接弹出nvue页面，参考这个插件

                        4、subNVue 比cover-view和plus.nativeObj.view更强大，也占用更多内存，
                        
                                为了保证更好的性能体验，一个vue页面不要加载太多 subNVue 子窗体，建议控制在三个以内
            */


        </script>
    </body>
</html>